###Function###
StdinWrite

###Description###
Schreibt eine Anzahl von Zeichen in den STDIN-Stream eines zuvor gestarteten Child-Prozesses.

###Syntax###
StdinWrite ( process_id [, data] )


###Parameters###
@@ParamTable@@
process_id
	Die Prozess-ID eines Child-Prozesses, wie aus einem vorigen Aufruf von Run zurckgegeben.
data
	[optional] Die auszugebenden Daten. Diese knnen entweder Text oder binr sein.
@@End@@

###ReturnValue###
@@ReturnTable@@
Erfolg:	Die Anzahl der geschriebenen Zeichen.
Fehler:	Setzt @error ungleich null, falls STDIN an diesen Prozess nicht weitergeleitet wurde oder falls ein anderer Fehler auftrat.
@@End@@


###Remarks###
<a href="StdinWrite.htm">StdinWrite()</a> schreibt in den Konsolen-Standard-Eingabe-Stream eines Child-Prozesses, der normalerweise von Konsolen-Applikationen genutzt wird, um Benutzereingaben zu lesen, z.B. von der Tastatur. Beim Aufrufs von <a href="Run.htm">Run</a> fr den Child-Prozess, in den man schreiben mchte, muss der STD I/O Parameter den Wert von $Stdin_Child (1) enthalten, damit diese Funktion richtig arbeitet (siehe die Funktion <a href="Run.htm">Run</a>).

Der zweite, optionale, Parameter enthlt den String, den man mit <a href="StdinWrite.htm">StdinWrite()</a> in den Stream schreiben mchte. Wenn die Funktion ohne zweites Argument aufgerufen wird, dann schliet <a href="StdinWrite.htm">StdinWrite()</a> den Stream und macht weiteres Schreiben in ihn ungltig.

Der Stream ist ein FIFO Puffer willkrlicher Grsse. Sollte, wann immer die Funktion aufgerufen wird (es sei denn, sie wird aufgerufen, um den Stream zu schliessen) nicht gengend Platz sein, um Zeichen in den Stream zu schreiben, blockiert (pausiert) <a href="StdinWrite.htm">StdinWrite()</a>, bis der Child-Prozess den Stream schliet oder gengend Zeichen aus dem Stream liest, um den Schreibvorgang zu vollenden. Das bedeutet, der AutoIt Prozess wird solange gestoppt -und es findet keine Verarbeitung von Hotkeys, GUI-Nachrichten, etc. statt- bis der Child-Prozess aus dem STDIN-Stream liest.

Zeichen werden in ANSI umgewandelt bevor diese geschrieben werden.

Binrdaten werden so geschrieben wie sie sind. Sie werden nicht in einen String umgewandelt.  Um die hex Darstellung von Binrdaten auszugebenen ist die <a href="String.htm">String()</a>-Funktion zu verwenden. Dadurch werden die Daten explizit in einen String umgewandelt.


###Related###
StdoutRead, StderrRead, StdioClose, Run, RunAs


###Example###
@@IncludeExample@@
